From 095ba92309358593e1a9b705e334d2b4d445493b Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Tue, 10 Jul 2007 05:28:52 +0000 Subject: [PATCH] Updates svn path=/trunk/; revision=18429 --- docs/reference/ChangeLog | 5 +++ docs/reference/gtk/gtk-builder-convert.1 | 29 +++++++++---- docs/reference/gtk/gtk-builder-convert.xml | 22 +++++++++- docs/reference/gtk/migrating-GtkBuilder.sgml | 43 +++++++++++++++++++- 4 files changed, 88 insertions(+), 11 deletions(-) diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index 785f7543ee..631272d62f 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,8 @@ +2007-07-10 Matthias Clasen + + * gtk/migrating-GtkBuilder.sgml: Add some stuff + * gtk/gtk-builder-convert.xml: Updates + 2007-07-09 Matthias Clasen * gdk-pixbuf/tmpl/scaling.sgml: Remove uses of deprecated api diff --git a/docs/reference/gtk/gtk-builder-convert.1 b/docs/reference/gtk/gtk-builder-convert.1 index af283d890e..444713bab9 100644 --- a/docs/reference/gtk/gtk-builder-convert.1 +++ b/docs/reference/gtk/gtk-builder-convert.1 @@ -1,11 +1,11 @@ .\" Title: gtk-builder-convert .\" Author: .\" Generator: DocBook XSL Stylesheets v1.72.0 -.\" Date: 06/26/2007 +.\" Date: 07/10/2007 .\" Manual: .\" Source: .\" -.TH "GTK\-BUILDER\-CONVERT" "1" "06/26/2007" "" "" +.TH "GTK\-BUILDER\-CONVERT" "1" "07/10/2007" "" "" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) @@ -13,20 +13,31 @@ .SH "NAME" gtk\-builder\-convert \- Glade file conversion utility .SH "SYNOPSIS" -.HP 25 -\fBgtk\-builder\-convert \fR\fB{file}\fR +.HP 20 +\fBgtk\-builder\-convert\fR [\-\-skip\-windows] [\-\-root\ \fIname\fR] {input} {output} .SH "DESCRIPTION" .PP \fBgtk\-builder\-convert\fR -converts glade files into XML files which can be loaded with GtkBuilder. +converts glade files into XML files which can be loaded with #GtkBuilder. .PP -It expects the name of a glade file as sole argument, and writes its output to stdout. -.SH "BUGS" +It expects the name of a glade file as the first argument, and writes its output the file specified as the second argument. +.SH "OPTIONS" .PP -GtkComboBox items are not converted into GtkListStore data. +\-\-skip\-windows, \-w +.RS 4 +Convert everything but GtkWindow subclasses. +.RE .PP -GtkTextView text is not converted into a GtkTextBuffer. +\-\-root, \-r +.RS 4 +Convert only the widget named +\fIname\fR +and its children. +.RE +.SH "BUGS" .PP Toolbars are not handled. .PP +Support for accessibility is not yet implemented. +.PP The script requires a python interpreter to run. diff --git a/docs/reference/gtk/gtk-builder-convert.xml b/docs/reference/gtk/gtk-builder-convert.xml index 85e3b2cf27..e0b6e1c30d 100644 --- a/docs/reference/gtk/gtk-builder-convert.xml +++ b/docs/reference/gtk/gtk-builder-convert.xml @@ -12,7 +12,11 @@ -gtk-builder-convert inputoutput +gtk-builder-convert +--skip-windows +--root name +input +output @@ -26,6 +30,22 @@ its output the file specified as the second argument. +Options + + + --skip-windows + -w + Convert everything but GtkWindow subclasses. + + + --root + -r + Convert only the widget named name + and its children. + + + + Bugs Toolbars are not handled. diff --git a/docs/reference/gtk/migrating-GtkBuilder.sgml b/docs/reference/gtk/migrating-GtkBuilder.sgml index e8ad571f70..2806ff9027 100644 --- a/docs/reference/gtk/migrating-GtkBuilder.sgml +++ b/docs/reference/gtk/migrating-GtkBuilder.sgml @@ -9,7 +9,48 @@ - More details about migrating from libglade to GtkBiulder will + While GtkBuilder strives to be a complete replacement for + libglade, there are a number of areas where it is currently + still behind libglade: + + + + GtkBuilder can not construct partial trees, it lacks + the equivalent of the @root parameter of glade_xml_new(). + Due to the way GtkBuilder parses its input, this is difficult + to implement, see + bug + 447998. As a workaround, you can split your glade file + into multiple GtkBuilder input files. The + gtk-builder-convert conversion script + has a option that can help with this. + + + + GtkBuilder does not yet implement support for accessibility + properties. It parses the same <accessibility> elements + as libglade, but ignores them. See + bug + 454983 for the current status of accessibility support + in GtkBuilder. + + + + GtkBuilder supports context information in translatable + properties in a slightly different way than libglade. + Intltool does not yet support this; see + bug + 454894 for the current status of intltool support for + GtkBuilder files. Thankfully, context in translations is a + rarely used feature, and if you are not using it, intltools + glade format support works just fine for GtkBuilder files. + + + + + + + More details about migrating from libglade to GtkBuilder will appear here over time... -- 2.30.2